# Location href Property

Location Object

## Example

Return the entire URL (of the current page):

var x = location.href;

The result of x will be:

Try it yourself »

More "Try it Yourself" examples below.

## Definition and Usage

The href property sets or returns the entire URL of the current page.

## Browser Support

Property |  |  |  |  |
--- | --- | --- | --- | --- | ---
href | Yes | Yes | Yes | Yes | Yes

## Syntax

Return the href property:

location.href

Set the href property:

location.href=URL

## Property Values

Value | Type | Description
--- | --- | ---

URL

String

Specifies the URL of the link.

Possible values:

- An absolute URL - points to another web site (like location.href="http://www.example.com/default.htm")
- A relative URL - points to a file within a web site (like location.href="default.htm")
- An anchor URL - points to an anchor within a page (like location.href="#top")
- A new protocol - specifies a different protocol (like location.href="ftp://someftpserver.com", location.href="mailto:someone@example.com" or location.href="file://host/path/example.txt")

## Technical Details

Return Value: | A String, representing the entire URL of the page, including the protocol (like http://)

## More Examples

## Example

Set the href value to point to another web site:

location.href = "http://www.cnn.com";
Try it yourself »

## Example

Set the href value to point to an anchor within a page:

location.href = "#top";
Try it yourself »

## Example

Set the href value to point to an email address (will open and create a new email message):

location.href = "mailto:someone@example.com";
Try it yourself »

Location Object

### WEB HOSTING

UK Reseller Hosting

### WEB BUILDING

FREE Website BUILDER Free HTML5 Templates

### W3SCHOOLS EXAMS

HTML, CSS, JavaScript, PHP, jQuery, XML, and ASP Certifications

### SHARE THIS PAGE

### Color Picker

### HTML/CSS

HTML Tutorial HTML5 Tutorial CSS Tutorial CSS3 Tutorial Bootstrap Tutorial

### JavaScript

JavaScript Tutorial jQuery Tutorial jQuery Mobile Tutorial AngularJS Tutorial AJAX Tutorial JSON Tutorial

### Graphics

Canvas Tutorial SVG Tutorial Google Maps Tutorial

### Server Side

SQL Tutorial PHP Tutorial ASP Tutorial ASP.NET Tutorial VBScript Tutorial AppML Tutorial

### Web

Web Building Web Statistics Web Certification

### XML

XML Tutorial DTD Tutorial Schema Tutorial XML DOM Tutorial XPath Tutorial XSLT Tutorial XQuery Tutorial XSL-FO Tutorial RSS Tutorial WSDL Tutorial

### HTML/CSS

HTML Tag Reference HTML Event Reference HTML Color Reference CSS 1,2,3 Reference Bootstrap Reference

### JavaScript

JavaScript Reference HTML DOM Reference jQuery Reference jQuery Mobile Reference Google Maps Reference

### Server Side

PHP Reference SQL Reference ASP Reference VBScript Reference Razor Reference ASP.NET Reference

### XML

XML DOM Reference XSLT Reference XSL-FO Reference XPath Reference XQuery Reference Schema Reference RSS Reference SVG Reference

### HTML Charsets

HTML Character Sets HTML ASCII HTML ANSI HTML Windows-1252 HTML ISO-8859-1 HTML Symbols HTML UTF-8

### HTML/CSS

HTML Examples CSS Examples

### Browser Scripting

JavaScript Examples HTML DOM Examples jQuery Examples jQuery Mobile Examples AngularJS Examples AJAX Examples

### Server Scripting

PHP Examples ASP Examples VBScript Examples Razor Examples .NET Examples

### XML Languages

XML Examples DTD Examples XML DOM Examples XSL Examples XSLT Examples XPath Examples XQuery Examples Schema Examples RSS Examples SVG Examples